home *** CD-ROM | disk | FTP | other *** search
/ The PC-SIG Library 10 / The PC-Sig Library - Shareware for the IBM PC and Compatibles (PC-SIG)(Tenth Edition Disks 1-2804)(1991).iso / PC_SIGCD / 19 / 9 / DISK1994.ZIP / DOSEZ.DOC < prev    next >
Text File  |  1989-03-24  |  30KB  |  809 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.                         WELCOME  TO  DOS-EZ
  7.  
  8.                             Version 1.0
  9.  
  10.                      Copyright (C) 1989 L. Chang
  11.                          All Rights Reserved
  12.  
  13.  
  14.                                 LICENSE
  15.  
  16.     This version of DOS-EZ is not a public domain nor free software, but is
  17.     being distributed as shareware.
  18.  
  19.     DOS-EZ is copyright (C) 1989 by L. Chang.
  20.  
  21.     All users granted a limited license to copy DOS-EZ only for the trial use.
  22.     Non-registered users of this software are granted a limited license to try
  23.     on a private, non-commercial basis. At the end of this trial period, you
  24.     should either register your copy or stop using it.
  25.  
  26.     This license does not include distribution and/or copying of this software :
  27.  
  28.     1)  in connection with any other product and/or service.
  29.     2)  for general use within a company, school, or institution.
  30.     3)  in modified form ; i.e.,  you should distribute or copy all utilities,
  31.         documents, and file contains license and registration information
  32.         to other user.
  33.  
  34.     The distributor of a public domain or user-supported software library may
  35.     distribute copies of DOS-EZ. Operator of bulletin board (Sysops) may post
  36.     DOS-EZ for down loading by their users as long as the conditions listed
  37.     above are met.
  38.  
  39.  
  40.                                DISCLAIMER
  41.  
  42.     The software and documentation which provided by the author or distributed
  43.     by dealers are working AS IS. I, L. Chang, can not accept any financial or
  44.     other responsibility that may be the result of your use of the information
  45.     in this documents and/or software material, including direct, indirect,
  46.     special, or consequential damages.
  47.  
  48.     While every precaution has been taken in the preparation of this software
  49.     and documents, the author assumes no responsibility for errors or
  50.     omissions.
  51.  
  52.     The information and functions contained in this software is subject to
  53.     change without notice. Revision may be issued to registered users.
  54.     Please use this software and documents with caution.
  55.  
  56.                             TRADEMARK
  57.  
  58. IBM and PC-DOS are trademarks of International Business Machines Corp.
  59. UNIX is a trademark of AT&T Bell Lab.
  60. MS-DOS, Microsoft C, and Quick C are trademarks of Microsoft Corp.
  61. Turbo C is a trademark of Borland International.
  62.  
  63.  
  64.                                 REGISTER
  65.  
  66.  
  67.     Why you need to register ?  By just paying $25 you can have the following
  68.     benefits :
  69.  
  70.     1) You can get an update or the next version just by paying a low update
  71.        fee. We will be writing more utilities for this package/project.
  72.        It will be available through the furture updates.
  73.  
  74.     2) Report any software defects to us, and we fix these bugs for you.
  75.  
  76.     3) The C source codes of all utilities can be make available to you at no
  77.        charge. All programs are written in "C", and they can be compiled by
  78.        Microsoft and/or Turbo C. With source codes, you can learn how to use
  79.        DOS and BIOS calls in "C". You also can use those source codes in your
  80.        applications.  If you adopt all or part of source codes in your
  81.        application program, the executable image of your application is royalty
  82.        free. This special offer is only available for DOS-EZ V1.0 , don't miss
  83.        this special chance.
  84.  
  85.     4) Support us to upgrade programs, maintain programs , and stay in business.
  86.  
  87.     We offer quantity discounts starting at 2nd copy. Corporate or site
  88.     licensing is also available. Please write for quantity discount pricing.
  89.     For single user license, please use register form (file name REGISTER.FOM )
  90.     to register your copy.  Order should be prepaid.
  91.  
  92.  
  93.                             CONTENT
  94.  
  95.            
  96. CRYPT      - Encrypt/Decrypt files
  97. DTREE      - Display tree structures of directories
  98. FDATE      - Change the date and time of files
  99. FGREP      - Search files for keywords
  100. FINDF      - Find where is files
  101. GREP       - Search files for a pattern; Get Regular Expression and Print
  102. MVFILES    - Move files from one directory to another directory
  103. NOW        - Display what time it is now
  104. RNDIR      - Rename sub-directory name
  105. SOUND      - Generate sound or beep
  106. SWAPF      - Swap file or directory
  107. VATTR      - Reset video foreground and background colors
  108. VIEW       - View a file
  109. WIPEOUT    - Write zero into your files and delete them
  110. XDEL       - Delete files, files in sub-directory, and remove sub-directory
  111. XDIR       - List files in directories
  112. XFIND      - Search files for a keyword
  113.  
  114.  
  115.  
  116. NAME
  117.     crypt - encrypt/decrypt files
  118.  
  119. SYNOPSIS
  120.     crypt [/c] password files
  121.  
  122. DESCRIPTION
  123.     This crypt utility use DES algorithm. You should know:
  124.     1)  If you forget the password after you encrypt files. They will be
  125.         almost impossible to recover.
  126.     2)  An Expert can decode your files by using a high speed computer. It
  127.         will be possible to decode your files by using new algorithms.
  128.     3)  The longer the password the more difficult it is to decode. Try to
  129.         use a password longer than 6 characters.
  130.         In order to decode a file with an 8 characters password, she/he would
  131.         have to try 95*95*95*95*95*95*95*95 times to find the correct one.
  132.         It takes about 10000000000 seconds to figure out by using 100 MIPS CPU.
  133.         Please bear statement in (2) in mind: someone is out there who may
  134.         know a fast way to find your password without 10^18 trials.
  135.     4)  Modifying this crypt source code can give you more protection.
  136.         (Registered  users can get source codes)
  137.  
  138.     /c : Conform before proceeding it.
  139.  
  140.     Password is case sensitive. Upper case is totally different from lower
  141.     case.
  142.     Wildcards '*' and '?' is allowed for specifying the file name.
  143.  
  144. EXAMPLES
  145.      crypt /c password c:\tax\1989*.wks   ; encrypt files with password
  146.      crypt    password c:\tax\1989tax.wks ; decrypt 1989tax.wks
  147.  
  148. DIAGNOSTIC
  149.      Password should be more than 2 characters.
  150.  
  151.  
  152. NAME
  153.     dtree - Display the tree structure of directory
  154.  
  155. SYNOPSIS
  156.     dtree [option] [pathname]
  157.  
  158. DESCRIPTION
  159.     dtree read the structure of specified pathanme and displays it in tree
  160.     structure. Without /f option you only see the relation between directory
  161.     and sub-directory. With /f option you'll see the entire structure.
  162.  
  163. EXAMPLES
  164.     dtree /f | view ; view the entry structure of current drive.
  165.     dtree c:mypath  ; display the structure of c:\mypath
  166.  
  167. SEE ALSO
  168.     dir, tree in DOS, view
  169.  
  170.  
  171. NAME
  172.     fdate - change the date and time of files
  173.  
  174. SYNOPSIS
  175.     fdate [/Dmm-dd-yyyy] [/Thh:mm] [files...]
  176.  
  177. DESCRIPTION
  178.     Fdate can change the date and/or time of files. Especially, when you
  179.     use MAKE to compile your programs, fdate can help you to change date
  180.     and time of files. This utility has another name called TOUCH.
  181.  
  182.     /D option let you specify new date for files.
  183.     /T option let you specify new time for files.
  184.  
  185.     Fdate won't change anything if you don't specify /D nor /T.
  186.     The input format of Date and Time is fixed. Please use '0' instead of
  187.     space when you specify date and/or time.
  188.  
  189.     With /D option :
  190.     mm   stands for month  ; month is 01 to 12.
  191.     dd   stands for day    ; day is 01 to 31.
  192.     yyyy stands for year   ; year is 1970 to 9999.
  193.  
  194.     With /T option :
  195.     hh   stands for hour   ; hour is 00 to 23.
  196.     mm   stands for minute ; minute is 00 to 59.
  197.  
  198. EXAMPLES
  199.     fdate /d01-01-1989 /t12:00 *.doc ; reset the date and time of all
  200.                                      ; "doc" files to 01-01-1989 12:00
  201.  
  202.  
  203. DIAGNOSTIC
  204.     Fdate will complain if you enter invalid date and/or time. For Example,
  205.     13-01-1989 and 24-61 are invalid date and time.
  206.  
  207. BUGS
  208.     Fdate does verify the date and/or time you specify, and fdate doesn't
  209.     rule out 02-31-1989 nor 04-31-1989. Although we know there is no
  210.     02-31-1989 nor 04-31-1989.
  211.  
  212.  
  213. NAME
  214.     fgrep - search files for multiple keywords
  215.  
  216. SYNOPSIS
  217.     fgrep [options] keywords files...
  218.  
  219. DESCRIPTION
  220.     Search files for keywords. Keywords can't contain wildcard '*' nor '?'.
  221.     Files can be text files or binary files. Fgrep can search files and files
  222.     in sub-directories for keywords. Keyword is separated by '|', so you
  223.     should use single or double quote (' or ") to enclose a pattern.
  224.  
  225.     The following options are recognized :
  226.  
  227.     /c      Only a count of matching lines is printed.
  228.     /i      Ignore upper/lower case.
  229.     /l      Only the names of files with matching lines are listed(once).
  230.     /n      Each line is proceeded by a line number.
  231.     /s      Suppress the error message produced for nonexistent file.
  232.     /v      All lines but those matching are listed.
  233.     /z      Search files in sub-directories also.
  234.  
  235. EXAMPLES
  236.     fgrep /ilz "mary|john|chris" *.dbs ; search all "dbs" files for mary, john
  237.                                        ; or chris.  Ignoring upper/lower case,
  238.                                        ; searching all sub-directories also,
  239.                                        ; and only listing the name of the file
  240.                                        ; with matching lines
  241.  
  242.     fgrep /n "mary|john" c:\dept1\*.wk1 c:\dept2\*.wks
  243.                                        ; Search all "wk1" files in c:\dept1
  244.                                        ; and all "wks" files in c:\dept2 for
  245.                                        ; keyword john or mary.  Display the
  246.                                        ; matching line with line number.
  247. SEE ALSO
  248.     find, xfind, grep and Technical Note.
  249.  
  250. DIAGNOSTIC
  251.     Keywords should be specified before files. If files are binary files, the
  252.     count of matching and line number make no sense at all. The pattern
  253.     should be fewer than 128 characters.
  254.  
  255. Technical Note
  256.     FGREP adopts Aho-Corasick algorithm to search files for keywords. This is
  257.     the same algorithm used by UNIX's fgrep. This algorithm should be the
  258.     fastest pattern searching algorithm to find "multiple" keywords. Because
  259.     it does not match keyword once at a time. If the text contains N
  260.     characters, this algorithm only needs N (at most) comparisons to know
  261.     whether text contains any keyword or not. No matter how many keywords you
  262.     specify.
  263.     Please refer to "Efficient String Matching : An Aid to Bibliographic
  264.     Search. CACM 1975 June" for more details.
  265.  
  266.  
  267. NAME
  268.     findf - find files in idsk
  269.  
  270. SYNOPSIS
  271.     findf [file...]
  272.  
  273. DESCRIPTION
  274.     Searching the entry drive to find the specified files. If you specify
  275.     directory with file name then findf only searches the directory you
  276.     specify and its sub-directories.
  277.  
  278. EXAMPLES
  279.     findf c:\income.tax ; search entry C drive to find file income.tax
  280.     findf c:income.tax  ; search the current directory and all sub-directories
  281.                         ;  to find file income.tax
  282.     findf c:\dos.*  d:\sys.h  ; searching entry C drive to find dos.* and
  283.                               ; searching entry D drive to find file sys.h
  284.  
  285. SEE ALSO
  286.     dir, xfind
  287.  
  288.  
  289. NAME
  290.     grep - search files for a pattern
  291.  
  292. SYNOPSIS
  293.     grep [options] Regular-Expression files...
  294.  
  295. DESCRIPTION
  296.     Grep searches the input files for lines matching a pattern. Patterns are
  297.     full regular expressions.
  298.     Grep can search binary files(e.g. object files). When the file is a binary
  299.     file, the line number and count of matching makes no sense at all.
  300.     Wildcards '*' and '?' are allowed to specify file names.
  301.  
  302.     The following options are recognized :
  303.  
  304.     /c      Only a count of matching lines is printed.
  305.     /fFILE  Get regular expression from FILE.
  306.     /i      Ignore upper/lower case.
  307.     /l      Only the names of files with matching lines are listed(once).
  308.     /n      Each line is proceeded by a line number.
  309.     /s      Suppress the error message produced for nonexistent file.
  310.     /v      All lines but those matching are listed.
  311.     /z      Search files in sub-directories also.
  312.  
  313.     The regular expression metacharacters are following :
  314.         \  ^  $  .  [  ]  |  (  )  *  +  ?
  315.  
  316.     The following table shows you regular expressions and the strings they
  317.     match :
  318.         c       matches the non-metacharacter c
  319.         \c      matches the escape sequence (see below)
  320.         $       matches the end of a string
  321.         ^       matches the beginning of a string
  322.         .       matches any single non-metacharacter
  323.         [xyz..] matches any of xyz..; character class
  324.         [^xy..] matches any single character but xy..
  325.         R|S     matches any string matched by R or S
  326.         RS      matches XY where R matches X and S matches Y
  327.         R*      matches zero or more consecutive strings matched by R
  328.         R+      matches one or more consecutive strings matched by R
  329.         R?      matches the null string or one string matched by R
  330.         (R)     matches string as R; grouping
  331.  
  332.     The operators are listed above in increasing precedence.
  333.  
  334.     The sequences listed below have special meaning in regular expressions and
  335.     strings :
  336.                 \b      backspace
  337.                 \f      formfeed
  338.                 \n      newline
  339.                 \r      carriage return
  340.                 \t      tab
  341.                 \ddd    ddd is three digit octal value. ddd may be 1 to 3 digits
  342.                 \c      any other character literally
  343.  
  344.  
  345. EXAMPLES
  346.     grep /c "open|file" *.obj c:\cc\*.bin ; match "open" or "file" in *.obj
  347.                                           ; and in c:\cc\*.bin
  348.  
  349.     grep /n "\[([0-9]+|[_a-zA-Z]+)\]" *.c ; match array subscript.
  350.     ; [0], [abc], [_id] is matched by above expression.
  351.     ; [0a]. [ a] [.a]   is not matched by above expression.
  352.     ; "\[([0-9]+|[_a-zA-Z0-9]+)\]" will match [0a] or [a0].
  353.  
  354.     Caution :
  355.         "Mary|John" matches Mary or John. It doesn't match Maryohn or MarJohn.
  356.  
  357.     "\/\*.*\*\/" will match a C comment statement.
  358.     "[+-]?[0-9]+[.]?[0-9]*" matches a decimal number with optional sign
  359.                              and optional fraction.
  360.     "[+-]?([0-9]+[.]?[0-9]*|[.][0-9]+)([eE][+-]?[0-9]+)?" matches a C/Pascal
  361.                              floating number or integer.
  362.     "[_a-zA-Z][_a-zA-Z0-9]*" matches a C variable.
  363.  
  364.                                       
  365. SEE ALSO
  366.     fgrep, xfind, find and Technical Note.
  367.  
  368. DIAGNOSTIC
  369.     The pattern should be fewer than 128 characters.
  370.  
  371. BUGS
  372.     You may get error message from DOS due to no more stack space. In this
  373.     case you need to recompile and link it with a bigger stack space.
  374.  
  375. Technical Note
  376.     GREP uses NFA (nondeterministic finite automaton) to match the pattern,
  377.     so it takes times rather than space.  This GREP read the input stream and
  378.     analyze the complexity of the pattern. If the pattern is only a keyword,
  379.     GREP will call a fast pattern searching routine based on Boyer-Moore's
  380.     algorithm. If the pattern is composed of multiple keywords, GREP will
  381.     call the routine based on Aho-Corasick's algorithm (the one we use in FGREP).
  382.     Otherwise, GREP will simulate an NFA to match the pattern. For example,
  383.     "grep 'mary' *.doc " will let GREP use Boyer-Moore's algorithm,
  384.     "grep 'mary|john' *.doc" will let GREP use Aho-Corasick's algorithm,
  385.     "grep 'marys?' *.doc " will let GREP simulate an NFA machine.
  386.     Boyer-Moore's algorithm is better than Knuth-Morris-Pratt's algorithm in
  387.     some situations. Please refer to "A Fast String Searching Algorithm 1977
  388.     CACM" for more details.
  389.  
  390.  
  391. NAME
  392.     mvfiles - move files from one directory to another directory
  393.  
  394. SYNOPSIS
  395.     mvfiles files pathname
  396.  
  397. DESCRIPTION
  398.     This is a more powerful RENAME utility. RENAME (in DOS) can only move one
  399.     file each time. Mvfiles allows you to use wildcard '*' and '?' to rename
  400.     files.  Just like RENAME, you are only allowed to move files within the
  401.     same drive.
  402.  
  403. EXAMPLES
  404.     mvfiles c:\1989\income.*   c:\tax
  405.     mvfiles *.c  .\test\sample
  406.  
  407. SEE ALSO
  408.     rename in DOS
  409.  
  410. DIAGNOSTIC
  411.     mvfiles will complain if you attempt to move files to different drive.
  412.  
  413.  
  414. NAME
  415.     now - Display current date and time.
  416.  
  417. SYNOPSIS
  418.     now
  419.  
  420. DESCRIPTION
  421.     Display current date and time.
  422.  
  423. SEE ALSO
  424.     date and time commands in DOS.
  425.  
  426.  
  427. NAME
  428.     rndir - rename subdirectory name
  429.  
  430. SYNOPSIS
  431.     rndir sub_dir1 sub_dir2
  432.  
  433. DESCRIPTION
  434.     Rename sub_dir1 to sub_dir2. You can only rename and not move.
  435.     What's that mean ?  It means that sub_dir1 and sub_dir2 should have
  436.     same parent directory. In other word, RNDIR C:\TAX\1988  C:\1989 is
  437.     not allowed because that 1988's parent directory is TAX, but 1989's
  438.     parent directory is C:\ .
  439.  
  440. EXAMPLES
  441.     rndir tc1 tc2 ; rename sub-directory TC1 to TC2.
  442.     rndir a:\tax\1988 a:\tax\1989
  443.     rndir c:\tax\1988 c:\1989 ; NO, This is an illegal command
  444.  
  445. SEE ALSO
  446.     mvfiles, del, rename
  447.  
  448. DIAGNOSTIC
  449.     rndir can only be used in DOS 3.x
  450.  
  451.  
  452. NAME
  453.     sound - Send a tone to speaker.
  454.  
  455. SYNOPSIS
  456.     sound [ frequency duration ] ...
  457.  
  458. DESCRIPTION
  459.     frequency : The frequency of the tone. A integer number is from
  460.                 20 to 20000 [Hz].   If frequency is zero then it means
  461.                 delay for some milliseconds.
  462.     duration  : The duration of the tone. A integer number is from
  463.                 55 to 65000 [milliseconds].
  464.  
  465. EXAMPLES
  466.     sound 440 500  ; This is Do
  467.     sound 1000 100 ; This is beep.
  468.     sound 440 500 0 1000 1000 100 ; Do , delay 1 second, and beep
  469.  
  470. BUGS
  471.     No warning will be issued if frequency is less than 20 or larger than
  472.     20000 Hz.
  473.     Duration will be set to 55 if it is less than 55.
  474.  
  475.  
  476. NAME
  477.     swapf - swap file
  478.  
  479. SYNOPSIS
  480.     swapf files1 files2
  481.  
  482. DESCRIPTION
  483.     SWAPF swap file's content or file name between file1 and file2.
  484.     If file1 and file2 are in the same directory, SWAPF then only swaps
  485.     their file name. If file1 and file2 are not in the same directory,
  486.     SWAPF then swaps content of files. File1 and file2 should be in the
  487.     same device (disk).
  488.  
  489. EXAMPLES
  490.     swapf c:\config.sys c:\config.tmp ; swap file name only
  491.  
  492.     swapf c:\1989\rules.new c:\1988\rules.old
  493.           ; After swapping, c:\1989 contains rules.old, c:\1988 contains
  494.           ; rules.new
  495.  
  496. SEE ALSO
  497.     rename, rndir, mvfiles.
  498.  
  499. BUGS
  500.     When you activate SWAPF, it will show the following messages :
  501.  
  502.         Move file1 to ________.___                   (1)
  503.         Move file2 to file1                          (2)
  504.         Move ________.___ to file2                   (3)
  505.  
  506.     If one of the above step fail, you'll get "Fail to move file because ..."
  507.     If (1) fail, SWAPF will exit right away.
  508.     If (2) fail, SWAPF will move ________.___ back to file1.
  509.     If (3) fail, SWAPF does nothing. Because if you can't move ________.___
  510.                  to file2, how could you move file1 back to file2.
  511.  
  512.     You may use SWAPF to swap directory. The following example shows you the
  513.     disadvantage you may have :
  514.  
  515.         swapf file.txt mydir ; After SWAPF, file.txt is a sub-directory name,
  516.                              ; mydir is a text file.
  517.                              ; Fortunately, you can issue
  518.                              ; "swapf file.txt mydir " to bring everything
  519.                              ; back.
  520.     You may use SWAPF to swap directory if your DOS version is 3.0 or up.
  521.     Under DOS 2.x, you are not able to rename directory name.
  522.  
  523.  
  524. NAME
  525.     vattr - set video attribute
  526.  
  527. SYNOPSIS
  528.     vattr [color]
  529.  
  530. DESCRIPTION
  531.     VATTR can reset your video attribute after DOS is activated. The easiest
  532.     way to specify the color code is entering VATTR without color code.
  533.     If you don't specify a color code, VATTR will display all 128 combinations
  534.     with color codes.  After VATTR displayed the entry color spectrums, you
  535.     can pick one color easily. The color code is a hexadecimal number.
  536.  
  537.     If you are using ANSI.SYS as the Terminal driver, you should use PROMPT
  538.     command to specify the color you want. VATTR can tell you whether you
  539.     are using ANSI.SYS as the terminal driver or not. Please consult your
  540.     DOS manual to help you to specify your video attribute if you are using
  541.     ANSI.SYS.
  542.  
  543. EXAMPLES
  544.     vattr           ; Display the entry color spectrums
  545.     vattr 1F        ; if you are using ANSI.SYS please use
  546.                     ; "PROMPT $e[37;44m" instead.
  547.                     ; vattr will set the screen to blue background and
  548.                     ; intense white foreground.
  549.  
  550. SEE ALSO
  551.     prompt, ansi.sys
  552.  
  553.  
  554. NAME
  555.     view - browsing a file
  556.  
  557. SYNOPSIS
  558.     view
  559.  
  560. DESCRIPTION
  561.     view reads data from STDIN and display it on user's screen.
  562.     No more "type read.me | more". view lets you read a file up to 60K bytes.
  563.     Function keys are defined as followed :
  564.  
  565.     PgUp    - Move up one page.
  566.     PgDn    - Move down one page.
  567.     Home    - Move to the first line of file.
  568.     End     - Move to the last line of file
  569.     Arrow Up- Move up one line.
  570.     Arrow Dn- Move down one line.
  571.     Esc     - Exit to DOS.
  572.  
  573. EXAMPLES
  574.     view < read.me  ; browse read.me : better than "type read.me | more"
  575.     dir | view      ; find out files in current directory
  576.                     ; same as dir > output; view < output
  577.  
  578. DIAGNOSTIC
  579.     view has only 60K bytes buffer, file larger than 60K will display only
  580.     the first 60K.
  581.  
  582. BUG
  583.     If you use pipe as the input of view you may see a file which was not
  584.     created by you. Indeed, that is the temporary file used as pipe by DOS.
  585.     After you exit to DOS, DOS will delete that file for you. For Example,
  586.     issue the command ,"dtree /f | view ", in DOS 3.1, you'll see one or two
  587.     files which filenames are composed of number.
  588.  
  589.  
  590. NAME
  591.     wipeout - Write zero to files and delete them.
  592.  
  593. SYNOPSIS
  594.     wipeout [/c] files
  595.  
  596. DESCRIPTION
  597.     wipeout writes zero to every byte of your file and then deletes it.
  598.     After that no one ever can recover this file.
  599.  
  600.     /c : Conform before proceeding to wipeout the file.
  601.  
  602.     Wildcard '*' and '?' is allowed to be used in file name.
  603.  
  604. EXAMPLES
  605.     wipeout /c c:\tax\1989tax.wsk
  606.     wipeout    c:\payroll\salary.*
  607.  
  608. DIAGNOSTIC
  609.     Complain if can not find the file.
  610.  
  611.  
  612. NAME
  613.     xdel - delete files and sub-directories
  614.  
  615. SYNOPSIS
  616.     xdel [files...]
  617.  
  618. DESCRIPTION
  619.     xdel deletes files and sub-directories. If sub-directory contains files,
  620.     xdel then deletes files in that sub-directory and removes that sub-
  621.     directory thereafter.
  622.  
  623. EXAMPLES
  624.     xdel *.* ; delete all files and sub-directories in current directory.
  625.     xdel *.c ; same as del *.c
  626.  
  627. SEE ALSO
  628.     del, erase, rndir, mvfiles
  629.  
  630.  
  631. NAME
  632.     xdir - Search files or directories and display them
  633.  
  634. SYNOPSIS
  635.     xdir [ [options] file ] ...
  636.  
  637. DESCRIPTION
  638.     XDIR provides two major functions to the user. The first function allows
  639.     you to specify what kinds of files you are looking for. You can search file
  640.     created and/or modified before/after/within certain date.
  641.     Options are following :
  642.  
  643.      /Bmm-dd-yyyy   Display files created/modified before mm-dd-yyyy
  644.      /Amm-dd-yyyy   Display files created/modified after mm-dd-yyyy
  645.                     You may use /B and /A at same time
  646.      /Imm-dd-yyyy   Display files created/modified on mm-dd-yyyy
  647.  
  648.      FORMAT :
  649.         mm    stands for MONTH starting from 01 to 12.
  650.         dd    stands for DAY starting from 01 to 31.
  651.         yyyy  stands for YEAR starting from 1980 to 9999.
  652.  
  653.      The format of date mentioned above is fixed format, so please use '0'
  654.      instead of SPACE (' ') to present leading zero.
  655.  
  656.      /T             Display files created/modified today
  657.      /Y             Display files created/modified yesterday
  658.      /On            Display files created/modified n days ago
  659.      /Ln            Display files created/modified within last n days
  660.  
  661.     The second function is to sort the output before user see them. XDIR allows
  662.     you to choose one of the following options :
  663.  
  664.      /SF            Sorted by file name before display
  665.      /SD            Sorted by date before display
  666.      /ST            Sorted by time before display
  667.      /SS            Sorted by size name before display
  668.  
  669.     You may use /R option to ask XDIR to sort the output in descending order.
  670.      /R             Sorted reverse order
  671.  
  672.     You may use /D option to search sub-directories only.
  673.      /D             Display sub-directories only
  674.  
  675.  
  676.     XDIR will display files and directories in the following format :
  677.  
  678.     File-Name        : DOS file format.
  679.     File-Attribute   : 5 characters.
  680.       1st character  : 'R' means this is a read only file.
  681.       2nd character  : 'H' means this is a hidden file.
  682.       3rd character  : 'S' means this is a system file.
  683.       4th character  : 'D' means this is a directory.
  684.       5th character  : 'A' means the archive bit of this file is set.
  685.  
  686.     Time             : HH:MM
  687.     Date             : MM-DD-YYYY
  688.     File-size        : one to ten digits integer.
  689.  
  690. EXAMPLES
  691.     xdir /a01-01-1988 /b01-01-1989 /sd *.inv  ; find all 1988 invoice files
  692.                                               ; and sorted by date.
  693.     xdir /l30 /sf c:\check\*.chk ; Find all checks issued since 30 days ago.
  694.     xdir /sf *.c /sd *.doc       ; Find all c programs and sorted by file name
  695.                                  ; before display them. Find all doc files
  696.                                  ; and sorted by date before display them.
  697.  
  698. SEE ALSO
  699.     dir, findf, and sort
  700.  
  701. BUGS
  702.     XDIR has only 512 file entries to keep the files/directories it finds.
  703.     If it finds more than 512 files, it'll skip the 513th file and files
  704.     after 513th.
  705.  
  706.  
  707. NAME
  708.     xfind - search files for a keyword
  709.  
  710. SYNOPSIS
  711.     xfind [options] keyword files...
  712.  
  713. DESCRIPTION
  714.     Search files for a keyword. Keyword can contain wildcards '*' and '?'.
  715.     '*' means matching zero or any string. '?' means matching any single
  716.     character. Files can be text files or binary files. xfind can search
  717.     files and files in sub-directories for a keyword.
  718.  
  719.     The following options are recognized :
  720.  
  721.     /a?     Replace wildcard '?' with the character after 'a'.
  722.     /c      Only a count of matching lines is printed.
  723.     /i      Ignore upper/lower case.
  724.     /l      Only the names of files with matching lines are listed(once).
  725.     /n      Each line is proceeded by a line number.
  726.     /s      Suppress the error message produced for nonexistent file.
  727.     /v      All lines but those matching are listed.
  728.     /w*     Replace wildcard '*' with the character after 'w'.
  729.     /z      Search files in sub-directories also.
  730.  
  731.     Thing you should know :
  732.     The wildcard '*' is a metacharacter in regular expression. It means
  733.     matching zero or any string. So, how about string after '*', do we need
  734.     to match it against text string ? In DOS file system, it will ignore
  735.     characters after '*'. In other word, 'ab*fg' matches 'ab', 'abc', 'abcfg'.
  736.     But in this utility when your keyword contains '*', it will try to match
  737.     characters after '*'. If it can't match characters after '*', it will
  738.     return 'notmatch' rather than 'match'. In other word, 'ab*fg' only matches
  739.     'abcfg' not 'abc' nor 'ab'. You can see the later matching algorithm is
  740.     more powerful than the one DOS uses in the DOS file system.
  741.  
  742.  
  743. EXAMPLES
  744.     xfind /ilz 'incom*tax??' *.wks; Search any WKS files for 'income*tax??'
  745.                                   ; in current directory and any WKS files
  746.                                   ; in sub-directories. If match just display
  747.                                   ; the file name and keep searching other
  748.                                   ; files. Ignore upper/lower case when it
  749.                                   ; preforms matching.
  750.     xfind /ilz /a~ 'income*tax~~' *.wks c:\1989\*.wk1
  751.                                   ; The function is same as the one listed
  752.                                   ; above. Except using '~' as the wildcard '?'.
  753. SEE ALSO
  754.     find, fgrep, grep and Technical Note.
  755.  
  756. DIAGNOSTIC
  757.     Keyword should be specified before files. If files are binary files, the
  758.     count of matching and line number make no sense at all. The keyword
  759.     should be fewer than 128 characters.
  760.  
  761. Technical Note :
  762.     XFIND adopts Knuth-Morris-Pratt fast pattern searching algorithm with
  763.     minor modification to search files for a keyword. This algorithm is one
  764.     of the fastest pattern searching algorithm. If there is an m characters
  765.     text and an n characters sub-string. By using conventional brute-force
  766.     algorithm, in the worst case you need to have (m-n)*m comparisons to know
  767.     whether this text contains sub-string. Instead, in the worst case KMP
  768.     algorithm only needs n comparisons to find the answer.
  769.     Please refer to "SIAM J. Computing 1977 6:2 Fast Pattern Matching in String"
  770.     for more details.
  771.  
  772.  
  773.  
  774.                     DOS-EZ     REGISTER     FORM
  775.  
  776.  
  777.     NAME    :______________________________________________________________
  778.  
  779.     ADDRESS :______________________________________________________________
  780.  
  781.              ______________________________________________________________
  782.  
  783.              ______________________________________________________________
  784.  
  785.     COMPANY
  786.      NAME :  ______________________________________________________________
  787.  
  788.  
  789.     DOS-EZ : $25.00
  790.  
  791.     Non
  792.     United
  793.     States
  794.     Users : $5.00
  795.     [Please add $5.00 to cover extra cost of shipping.]
  796.  
  797.     TOTAL :  _______________
  798.  
  799.     All amount listed above are U. S. currency.
  800.  
  801.     Please send money order or check (only U.S. users) with amount listed in
  802.     TOTAL and this register form to the following address.
  803.  
  804.                        L. Chang
  805.                     P.O. BOX 201995
  806.                   Mpls, MN  55420-1955
  807.  
  808.  
  809.